---
image: /generated/articles-docs-media-parser-tags.png
id: tags
sidebar_label: Extract ID3 tags
title: Extract ID3 tags and EXIF data
slug: /media-parser/tags
crumb: '@remotion/media-parser'
---

:::warning
[We are phasing out Media Parser and are moving to Mediabunny](/blog/mediabunny)!
:::

[`@remotion/media-parser`](/docs/media-parser) allows you to extract metadata that is embedded in video files, such as ID3 tags or EXIF data.

```tsx twoslash title="Extracting metadata"
import {parseMedia} from '@remotion/media-parser';

const {metadata} = await parseMedia({
  src: 'https://remotion.media/video.mp4',
  fields: {
    metadata: true,
  },
});

console.log(metadata);

/*
[
  {
    key: 'com.apple.quicktime.model',
    trackId: null,
    value: 'iPhone 15 Pro',
  },
  {
    key: 'encoder',
    trackId: null,
    value: 'Lavf57.19.100',
  }
]
*/
```

Some metadata refers to a certain track, such as the 'encoder' field.  
In this case, the `trackId` field will contain a non-null value. You can get a list of tracks by setting the [`tracks`](/docs/media-parser/fields#tracks) field to `true`.

## Common metadata fields

Here is a non-exhaustive list of commonly seen metadata that you may want to parse and display.  
Use the [`container`](/docs/media-parser/fields#container) field to get the container format of the video.

### ISO Base Media (.mp4, .mov)

| Field                                                     | Description                                                                                                                                                                                                                                          | Example value                                            |
| --------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
| `artist`                                                  | ID3 Artist Tag                                                                                                                                                                                                                                       | `"Blender Foundation 2008, Janus Bager Kristensen 2013"` |
| `album`                                                   | ID3 Album Tag                                                                                                                                                                                                                                        | `"The Resistance"`                                       |
| `composer`                                                | ID3 Composer Tag                                                                                                                                                                                                                                     | `"Sacha Goedegebure"`                                    |
| `comment`                                                 | ID3 Comment Tag                                                                                                                                                                                                                                      | `"Made with Remotion 4.0.234"`                          |
| `releaseDate`                                             | ID3 Release Date Tag                                                                                                                                                                                                                                 |                                                          |
| `genre`                                                   | ID3 Genre Tag                                                                                                                                                                                                                                        | `"Animation"`                                            |
| `title`                                                   | ID3 Title Tag                                                                                                                                                                                                                                        | `"Big Buck Bunny, Sunflower version"`                    |
| `writer`                                                  | ID3 Writer Tag                                                                                                                                                                                                                                       | `"Sacha Goedegebure"`                                    |
| `director`                                                | ID3 Director Tag                                                                                                                                                                                                                                     |                                                          |
| `producer`                                                | ID3 Producer Tag                                                                                                                                                                                                                                     |                                                          |
| `description`                                             | ID3 Description Tag                                                                                                                                                                                                                                  |                                                          |
| `duration`                                                | ID3 Duration Tag                                                                                                                                                                                                                                     | `"00:00:10.000000000"`                                   |
| `encoder`                                                 | Software used to encode the video/stream                                                                                                                                                                                                             | `"Lavf60.16.100"`                                        |
| `copyright`                                               | Copyright information                                                                                                                                                                                                                                | `"Blender Foundation"`                                   |
| `major_brand`                                             | The major brand of the file                                                                                                                                                                                                                          | `"isom"`                                                 |
| `minor_version`                                           | The minor version of the file                                                                                                                                                                                                                        | `"512"`                                                  |
| `compatible_brands`                                       | Container compatibility                                                                                                                                                                                                                              | `"isomav01iso2mp41"`                                     |
| `handler_name`                                            | Software used to mux the video                                                                                                                                                                                                                       | `"GPAC ISO Video Handler"`                               |
| `com.apple.quicktime.camera.focal_length.35mm_equivalent` | [35mm-equivalent focal length](https://en.wikipedia.org/wiki/35_mm_equivalent_focal_length)                                                                                                                                                          | `23`                                                     |
| `com.apple.quicktime.camera.lens_model`                   | Lens of Apple Device                                                                                                                                                                                                                                 | `"iPhone 15 Pro back camera 6.765mm f/1.78"`             |
| `com.apple.quicktime.creationdate`                        | Creation date of video                                                                                                                                                                                                                               | `"2024-10-01T12:46:18+0200"`                             |
| `com.apple.quicktime.software`                            | Operating System Version (e.g. iOS) of Device                                                                                                                                                                                                        | `"18.0"`                                                 |
| `com.apple.quicktime.model`                               | Device used to capture video                                                                                                                                                                                                                         | `"iPhone 15 Pro"`                                        |
| `com.apple.quicktime.make`                                | Maker of the device used to capture the video                                                                                                                                                                                                        | `"Apple"`                                                |
| `com.apple.quicktime.live-photo.vitality-score`           | [An identifier that represents the vitality score of a Live Photo movie](https://developer.apple.com/documentation/avfoundation/avmetadataidentifier/quicktimemetadatalivephotovitalityscore)                                                        | `1`                                                      |
| `com.apple.quicktime.live-photo.vitality-scoring-version` | [An identifier that represents the version of the algorithm responsible for scoring the Live Photo movie for vitality](https://developer.apple.com/documentation/avfoundation/avmetadataidentifier/quicktimemetadatalivephotovitalityscoringversion) | `4`                                                      |
| `com.apple.quicktime.content.identifier`                  | [An identifier that represents the content identifier in QuickTime](https://developer.apple.com/documentation/avfoundation/avmetadataidentifier/quicktimemetadatacontentidentifier)                                                                  | `"2C1C7C94-E977-45D0-9B3F-9A9CA8EFB47D"`                 |
| `com.apple.quicktime.full-frame-rate-playback-intent`     | [An key that represents whether this movie should play at full frame rate](https://developer.apple.com/documentation/avfoundation/avmetadatakey/quicktimemetadatakeyfullframerateplaybackintent)                                                     | `1`                                                      |
| `com.apple.quicktime.live-photo.auto`                     | [An identifier that represents whether the live photo movie used auto mode](https://developer.apple.com/documentation/avfoundation/avmetadataidentifier/quicktimemetadataautolivephoto?language=objc)                                                | `1`                                                      |
| `com.apple.quicktime.location.accuracy.horizontal`        | [An identifier that represents the horizontal accuracy of the location data](https://developer.apple.com/documentation/avfoundation/avmetadataidentifier/quicktimemetadatalocationhorizontalaccuracyinmeters)                                        | `1`                                                      |
| `com.apple.quicktime.information`                         | General information                                                                                                                                                                                                                                  | `"Captured with VisionCamera by mrousavy"`               |

### Matroska (.mkv, .webm)

| Field      | Description                          | Example value                  |
| ---------- | ------------------------------------ | ------------------------------ |
| `duration` | Duration of a video / stream         | `"00:00:00.333000000"`         |
| `encoder`  | Software used to encode stream/Video | `"Lavc60.31.102 libx264"`      |
| `comment`  | Software used to encode stream/Video | `"Made with Remotion 4.0.192"` |

### RIFF (.avi)

| Field     | Description                          | Example value     |
| --------- | ------------------------------------ | ----------------- |
| `encoder` | Software used to encode stream/Video | `"Lavf57.19.100"` |

### MP3

See [here](https://exiftool.org/TagNames/ID3.html) for a list of tags that can be returned.  
The `APIC` tag will not be returned as part of the `metadata` field, but separately as elements in the [`images`](/docs/media-parser/fields#images) array.

### WAV

| Field  | Description                          | Example value                         |
| ------ | ------------------------------------ | ------------------------------------- |
| `ISFT` | Software used to encode stream/Video | `"Lavf60.16.100 (libsndfile-1.0.31)"` |

### FLAC

| Field         | Description                          | Example value                        |
| ------------- | ------------------------------------ | ------------------------------------ |
| `vendor`      | Software used to encode stream/Video | `"reference libFLAC 1.3.2 20190804"` |
| `title`       | Name of the track                    | `"The Happy Meeting"`                |
| `date`        | Recording date, or year              | `"2020"`                             |
| `album`       | Music album                          | `"Sample files"`                     |
| `artist`      | Music artist                         | `"Sample files"`                     |
| `tracknumber` | Index of song in album               | `"4"`                                |
| `genre`       | Music genre                          | `"Ambient"`                          |

See more: https://www.rfc-editor.org/rfc/rfc9639.html#name-standard-field-names

## Fields are not unique

Some fields may appear multiple times per video, such as `encoder`, `comment` or `duration`.  
Oftentimes they are scoped to a certain track, which is why the `trackId` field is present in the metadata object.

## See also

- [`parseMedia()`](/docs/media-parser/parse-media)
